home *** CD-ROM | disk | FTP | other *** search
/ Virtual Communities Companion / Virtual Communities Companion.iso / disk1 / chatbox / cb21demo.exe / chatbox.z / faq.txt < prev    next >
Encoding:
Text File  |  1997-04-29  |  4.3 KB  |  84 lines
  1. ChatBox Frequently Asked Questions List
  2.  
  3. - How do I install chatbox?
  4.  
  5. Run "setup.exe" from the command line or Explorer.  This will ask you where ChatBox
  6. should be installed, what ports you want ChatBox and its admin server to listen to, and
  7. where e-mail reporting errors should be sent.
  8.  
  9. - How do I uninstall chatbox?
  10.  
  11. First, shut down both ChatBox and ChatBox Admin server, preferably by using their "-remove" 
  12. switches (that is, run "chatbox -remove" and "chatboxadmin -remove").  Then use Add/Remove
  13. Programs from the control panel.
  14.  
  15. - Graphics referred to by the HTE files aren't displaying!
  16.  
  17. Some servers (like Netscape Enterprise Server) will try to treat *any* file under the 
  18. CGI scripts directory as a script.  Probably you have tried to put a graphic in the directory
  19. where your HTE files reside (roomname/config/misc).  You'll have to move it and update the
  20. referring HTE file.
  21.  
  22. - How do I change the look of a room?
  23.  
  24. By editing the HTE files in $chatroot/config/*.  Except for a small set of new tags which are
  25. interpreted by the ChatBox server, these are ordinary HTML files.
  26.  
  27. - What are the various HTE files for?
  28.  
  29. misc/berr.hte:     The page sent when CHAT.EXE does not recognize a user's browser type
  30. misc/exit.hte:     The page sent when a user logs off ChatBox
  31. misc/locked.hte:   The page sent when a user tries to log into a full ChatBox room
  32. misc/login.hte:    The page displayed when a user logs in
  33. push/pushmain.hte: The page which describes the appearance of a chat room
  34.  
  35. - What are the HTE tags?
  36.  
  37. There's only one, really: the <chatbox> tag.  <chatbox> takes one of several arguments:
  38.  
  39. <chatbox redirect=url>       Redirects the browser to the given URL
  40. <chatbox usercount>          Replaced with the number of users currently logged in
  41. <chatbox timestamp>          Replaced with the current time in "hh:mm:ss tz" format
  42. <chatbox login form>         The start of the form which prompts for a user name
  43. <chatbox errormessage>       Replaced with the error message text if a login fails
  44. <chatbox chatarea>           Replaced with the GIF containing the chat text
  45. <chatbox gif argument value> The tag which controls the appearance of the GIF.  Valid
  46.                                arguments are:
  47.  
  48.                                   argument     value     meaning
  49.                                                                 LMARG        integer   left margin size
  50.                                                                     RMARG        integer   right margin size
  51.                                                                     BMARG        integer   bottom margin size
  52.                                                                     TMARG        integer   top margin size
  53.                                                                     BRED         integer   Red component of background of gif (0-255)
  54.                                                                     BGREEN       integer   Green component of background
  55.                                                                     BBLUE        integer   Blue component of background
  56.                                                                     FRED         integer   Red component of text
  57.                                                                     FGREEN       integer   Green component of text
  58.                                                                     FBLUE        integer   Blue component of text
  59.                                                                     INTERLACE    Y|N       Controls interlacing of gif
  60.                                                                     SPACING      integer   Spacing between lines of text
  61.  
  62.                                                             These are read by ChatBox from config/push/pushmain.hte
  63.                                                             once for each room at startup.  For changes to them to
  64.                                                             take effect, ChatBox must be restarted.
  65. <chatbox post form>                     The start of the form which controls posting
  66. <chatbox logoff form>                 The start of the form which controls logging off.
  67.  
  68. The tags which say "form" start a standard HTML form, ended with </form>.  These forms require
  69. certain input areas to be specified by the administrator:
  70.  
  71. <chatbox login form>:  The username goes in a field called NEWUSER.  A "submit" button must also
  72.                                    be specified.
  73. <chatbox post form>:  A text input line named MESSAGE must be provided.
  74. <chatbox logoff form>:  A "Submit" button named "Log off" must be provided.
  75.  
  76. See the HTE files which came in the ChatBox distribution for an example of the use of these in
  77. context.
  78.  
  79. - What's this <CHATBOX INPUT> in push/form.hte and push/pushmain.hte?
  80.  
  81. A workaround for a bug in Internet Explorer.  Since IE uses a Java applet instead of a form for
  82. the logoff button, the submit button must be disguised in some way.  CHAT.EXE strips out any
  83. <CHATBOX INPUT> tag if the brower type is MSIE.
  84.